home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / satwrite.z / satwrite
Encoding:
Text File  |  1998-10-20  |  5.5 KB  |  131 lines
  1.  
  2.  
  3.  
  4. ssssaaaattttwwwwrrrriiiitttteeee((((2222))))                                                        ssssaaaattttwwwwrrrriiiitttteeee((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      satwrite, satvwrite - write a block of audit record data
  10.  
  11. CCCC SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ssssaaaatttt....hhhh>>>>
  13.      iiiinnnntttt ssssaaaattttwwwwrrrriiiitttteeee ((((iiiinnnntttt eeeevvvveeeennnntttt,,,, iiiinnnntttt oooouuuuttttccccoooommmmeeee,,,, cccchhhhaaaarrrr ****bbbbuuuuffffffffeeeerrrr,,,, uuuunnnnssssiiiiggggnnnneeeedddd nnnnbbbbyyyytttteeeessss))))
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssttttddddaaaarrrrgggg....hhhh>>>> ####iiiinnnncccclllluuuuddddeeee <<<<ssssaaaatttt....hhhh>>>>
  15.      iiiinnnntttt ssssaaaattttvvvvwwwwrrrriiiitttteeee ((((iiiinnnntttt eeeevvvveeeennnntttt,,,, iiiinnnntttt oooouuuuttttccccoooommmmeeee,,,, cccchhhhaaaarrrr ****ffffoooorrrrmmmmaaaatttt,,,, ............))))
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _s_a_t_w_r_i_t_e writes _n_b_y_t_e_s bytes to the security audit trail record queue
  19.      from the buffer pointed to by _b_u_f_f_e_r.
  20.  
  21.      _s_a_t_v_w_r_i_t_e is a more convenient libc interface for generating audit
  22.      records, which are generally text strings.  _F_o_r_m_a_t is a printf-like
  23.      format string, followed by a variable number of arguments.  See
  24.      _p_r_i_n_t_f(3S) for more information on the possible formatting characters.
  25.  
  26.      _E_v_e_n_t must be equal to one of the SAT record type constants for
  27.      administrative events, as defined in /_u_s_r/_i_n_c_l_u_d_e/_s_y_s/_s_a_t._h. Permissible
  28.      values are:
  29.  
  30.      SSSSAAAATTTT____AAAAEEEE____AAAAUUUUDDDDIIIITTTT        _s_a_t_w_r_i_t_e is called by audit subsystem utilities.
  31.  
  32.      SSSSAAAATTTT____AAAAEEEE____IIIIDDDDEEEENNNNTTTTIIIITTTTYYYY     _s_a_t_w_r_i_t_e is called by programs in the identification
  33.                          and authentication subsystem.
  34.  
  35.      SSSSAAAATTTT____AAAAEEEE____DDDDBBBBEEEEDDDDIIIITTTT       _s_a_t_w_r_i_t_e is called by the program which edits
  36.                          administrative databases.
  37.  
  38.      SSSSAAAATTTT____AAAAEEEE____MMMMOOOOUUUUNNNNTTTT        _s_a_t_w_r_i_t_e is called by the programs which mount
  39.                          filesystems.
  40.  
  41.      SSSSAAAATTTT____AAAAEEEE____CCCCUUUUSSSSTTTTOOOOMMMM       _s_a_t_w_r_i_t_e is called by customer written self auditing
  42.                          applications.
  43.  
  44.      _o_u_t_c_o_m_e should be equal to SSSSAAAATTTT____SSSSUUUUCCCCCCCCEEEESSSSSSSS or SSSSAAAATTTT____FFFFAAAAIIIILLLLUUUURRRREEEE, as defined in
  45.      /_u_s_r/_i_n_c_l_u_d_e/_s_y_s/_s_a_t._h. _s_a_t_w_r_i_t_e interprets any value other than
  46.      SSSSAAAATTTT____FFFFAAAAIIIILLLLUUUURRRREEEE as an alternate representation of SSSSAAAATTTT____SSSSUUUUCCCCCCCCEEEESSSSSSSS.
  47.  
  48.      _B_u_f_f_e_r should contain audit data in human readable form.  Although there
  49.      are no restrictions on its content, _s_a_t__i_n_t_e_r_p_r_e_t(1m) always interprets
  50.      the data as a null-terminated string.
  51.  
  52. EEEERRRRRRRROOOORRRRSSSS
  53.      _s_a_t_w_r_i_t_e fails if these conditions are true:
  54.  
  55.      [ENOPKG]       Audit is not configured on this system.
  56.  
  57.  
  59.  
  60.  
  61.                                                                         PPPPaaaaggggeeee 1111
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68. ssssaaaattttwwwwrrrriiiitttteeee((((2222))))                                                        ssssaaaattttwwwwrrrriiiitttteeee((((2222))))
  69.  
  70.  
  71.  
  72.      [EPERM]        The caller does not have CCCCAAAAPPPP____AAAAUUUUDDDDIIIITTTT____WWWWRRRRIIIITTTTEEEE capability.
  73.  
  74.      [EINVAL]       _b_u_f_f_e_r is null, or _n_b_y_t_e_s is greater than
  75.                     SSSSAAAATTTT____MMMMAAAAXXXX____UUUUSSSSEEEERRRR____RRRREEEECCCC.
  76.  
  77.      [EDOM]         _e_v_e_n_t is not one of the permitted values.
  78.  
  79.      [EFAULT]       data can't be copied from _b_u_f_f_e_r into the kernel.
  80.  
  81. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  82.      A return value of ----1111 indicates an error and _e_r_r_n_o is set to indicate the
  83.      error.  Otherwise 0000 is returned.
  84.  
  85. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  86.      sat_echo(1m), satoff(2), saton(2), satread(2), satstate(2), printf(3S)
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                                                         PPPPaaaaggggeeee 2222
  128.  
  129.  
  130.  
  131.